Un objet App GeoFeature, ou officiellement App::GeoFeature
, est la classe de base de la plupart des objets qui afficheront des éléments géométriques dans la Vue 3D car il inclut une propriété DonnéesPlacement.
Diagramme simplifié des relations entre les objets centraux dans Freecad
App GeoFeature est un objet interne, il ne peut donc pas être créé à partir de l'interface graphique. Il n'est généralement pas destiné à être utilisé directement, mais il peut plutôt être sous-classé pour obtenir un objet nu qui n'a qu'une propriété DonnéesPlacement de base pour définir sa position dans la vue 3D.
Certains des objets dérivés les plus importants sont les suivants :
Lorsque vous créez cet objet dans Python, au lieu de sous-classer App::GeoFeature
, vous devez sous-classer App::GeometryPython
car ce dernier inclut une valeur par défaut fournisseur de vues et attributs Proxy
pour l'objet lui-même et son fournisseur de vues. Voir Script.
Voir Propriétés pour tous les types de propriétés que les objets crées par script peuvent avoir.
App GeoFeature (classe App::GeoFeature
) est dérivée de la classe de base App DocumentObject. (classe App::DocumentObject
) et hérite de toutes ses propriétés. En outre, il possède une propriété DonnéesPlacement, qui contrôle sa position dans la vue 3D.
Voir Propriétés pour tous les types de propriétés que les objets scriptés peuvent avoir.
La classe App GeometryPython (classe App::GeometryPython
) est dérivée de la classe de base App GeoFeature (classe App::GeoFeature
) et hérite de toutes ses propriétés. Elle possède également plusieurs propriétés supplémentaires.
Ce sont les propriétés disponibles dans l'éditeur de propriétés. Les propriétés masquées peuvent être affichées en utilisant la commande Tout afficher dans le menu contextuel de l'éditeur de propriétés.
Base
PythonObject
) : une classe personnalisée associée à cet objet.Placement
): la position de l'objet dans la Vue 3D. Le placement est défini par un point Base
(vecteur) et un Rotation
(axe et angle). Voir Positionnement.
0°
(zéro degré).0
et 1
. Si une valeur est supérieure à 1
, le vecteur est normalisé de sorte que l'amplitude du vecteur est 1
. Par défaut, il s'agit de l'axe Z positif, (0, 0, 1)
.(0, 0, 0)
.String
): le nom modifiable par l'utilisateur de cet objet, il s'agit d'une chaîne UTF8 arbitraire.String
) : une description plus longue, modifiable par l'utilisateur, de cet objet. Il s'agit d'une chaîne UTF8 arbitraire qui peut inclure des nouvelles lignes. Par défaut, il s'agit d'une chaîne vide ""
.ExpressionEngine
) : une liste d'expressions. Par défaut, elle est vide []
.Bool
) : affichage ou non de l'objet.
Base
PythonObject
): une classe personnalisée de viewprovider associée à cet objet.Display Options
Bool
): mis à true
, l'objet affichera le cadre de délimitation dans la Vue 3D.Enumeration
): voir les informations dans App FeaturePython.Bool
): voir les informations dans App FeaturePython.Bool
): voir les informations dans App FeaturePython.Object Style
Color
): un tuple de trois valeurs RVB à virgule flottante (r,g,b)
pour définir la couleur des faces dans la Vue 3D. Par défaut, il s'agit de (0.8, 0.8, 0.8)
, qui s'affiche sous la forme [204, 204, 204]
sur la base 255, un light gray .Material
): un App Material associé à cet objet. Par defaut, vide.Percent
): un entier de 0
à 100
qui détermine le niveau de transparence des faces dans la Vue 3D. Une valeur de 100
indique des faces complètement invisibles. Les faces sont invisibles mais elles peuvent toujours être sélectionnées tant que VueSelectable est true
.Selection
Enumeration
): voir les informations dans App FeaturePython.Bool
): s'il est true
, l'objet peut être sélectionné avec le pointeur dans la Vue 3D. Sinon, l'objet ne peut pas être sélectionné tant que cette option n'est pas définie sur true
.Enumeration
): voir les informations dans App FeaturePython.
Voir aussi : Débuter avec les scripts et Objets créés par script.
Voir Part Feature pour les informations générales sur l'ajout d'objets au document.
Un GeoFeature est créé avec la méthode addObject()
du document. Si vous souhaitez créer un objet avec une 2D ou 3D forme topologique, il peut être préférable de créer l'une des sous-classes spécialisées pour la manipulation des formes, par exemple, Part Feature ou Part Part2DObject.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeoFeature", "Name")
obj.Label = "Custom label"
Pour la sous-classification de Python, vous devez créer l'objet App::GeometryPython
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeometryPython", "Name")
obj.Label = "Custom label"